@ckeditor/ckeditor5-engine 36.0.0 → 37.0.0-alpha.0

package/src/view/element.js

@@ -11,7 +11,6 @@ import TextProxy from './textproxy';
 import { isIterable, toArray, toMap } from '@ckeditor/ckeditor5-utils';
 import { default as Matcher } from './matcher';
 import { default as StylesMap } from './stylesmap';
-import { isPlainObject } from 'lodash-es';
 // @if CK_DEBUG_ENGINE // const { convertMapToTags } = require( '../dev-utils/utils' );
 /**
  * View element.
@@ -35,8 +34,6 @@ import { isPlainObject } from 'lodash-es';
  * {@link module:engine/controller/datacontroller~DataController#set data.set} it is not possible to define the type of the element.
  * In such cases the {@link module:engine/view/upcastwriter~UpcastWriter#createElement `UpcastWriter#createElement()`} method
  * should be used to create generic view elements.
- *
- * @extends module:engine/view/node~Node
  */
 export default class Element extends Node {
     /**
@@ -44,49 +41,43 @@ export default class Element extends Node {
      *
      * Attributes can be passed in various formats:
      *
-     *		new Element( viewDocument, 'div', { class: 'editor', contentEditable: 'true' } ); // object
-     *		new Element( viewDocument, 'div', [ [ 'class', 'editor' ], [ 'contentEditable', 'true' ] ] ); // map-like iterator
-     *		new Element( viewDocument, 'div', mapOfAttributes ); // map
+     * ```ts
+     * new Element( viewDocument, 'div', { class: 'editor', contentEditable: 'true' } ); // object
+     * new Element( viewDocument, 'div', [ [ 'class', 'editor' ], [ 'contentEditable', 'true' ] ] ); // map-like iterator
+     * new Element( viewDocument, 'div', mapOfAttributes ); // map
+     * ```
      *
-     * @protected
-     * @param {module:engine/view/document~Document} document The document instance to which this element belongs.
-     * @param {String} name Node name.
-     * @param {Object|Iterable} [attrs] Collection of attributes.
-     * @param {module:engine/view/node~Node|Iterable.<module:engine/view/node~Node>} [children]
-     * A list of nodes to be inserted into created element.
+     * @internal
+     * @param document The document instance to which this element belongs.
+     * @param name Node name.
+     * @param attrs Collection of attributes.
+     * @param children A list of nodes to be inserted into created element.
      */
     constructor(document, name, attrs, children) {
         super(document);
         /**
-         * Name of the element.
+         * A list of attribute names that should be rendered in the editing pipeline even though filtering mechanisms
+         * implemented in the {@link module:engine/view/domconverter~DomConverter} (for instance,
+         * {@link module:engine/view/domconverter~DomConverter#shouldRenderAttribute}) would filter them out.
          *
-         * @readonly
-         * @member {String}
-         */
-        this.name = name;
-        /**
-         * Map of attributes, where attributes names are keys and attributes values are values.
+         * These attributes can be specified as an option when the element is created by
+         * the {@link module:engine/view/downcastwriter~DowncastWriter}. To check whether an unsafe an attribute should
+         * be permitted, use the {@link #shouldRenderUnsafeAttribute} method.
          *
-         * @protected
-         * @member {Map} #_attrs
+         * @internal
          */
-        this._attrs = parseAttributes(attrs);
+        this._unsafeAttributesToRender = [];
         /**
-         * Array of child nodes.
-         *
-         * @protected
-         * @member {Array.<module:engine/view/node~Node>}
+         * Map of custom properties.
+         * Custom properties can be added to element instance, will be cloned but not rendered into DOM.
          */
+        this._customProperties = new Map();
+        this.name = name;
+        this._attrs = parseAttributes(attrs);
         this._children = [];
         if (children) {
             this._insertChild(0, children);
         }
-        /**
-         * Set of classes associated with element instance.
-         *
-         * @protected
-         * @member {Set}
-         */
         this._classes = new Set();
         if (this._attrs.has('class')) {
             // Remove class attribute and handle it by class set.
@@ -94,55 +85,21 @@ export default class Element extends Node {
             parseClasses(this._classes, classString);
             this._attrs.delete('class');
         }
-        /**
-         * Normalized styles.
-         *
-         * @protected
-         * @member {module:engine/view/stylesmap~StylesMap} module:engine/view/element~Element#_styles
-         */
         this._styles = new StylesMap(this.document.stylesProcessor);
         if (this._attrs.has('style')) {
             // Remove style attribute and handle it by styles map.
             this._styles.setTo(this._attrs.get('style'));
             this._attrs.delete('style');
         }
-        /**
-         * Map of custom properties.
-         * Custom properties can be added to element instance, will be cloned but not rendered into DOM.
-         *
-         * @protected
-         * @member {Map}
-         */
-        this._customProperties = new Map();
-        /**
-         * A list of attribute names that should be rendered in the editing pipeline even though filtering mechanisms
-         * implemented in the {@link module:engine/view/domconverter~DomConverter} (for instance,
-         * {@link module:engine/view/domconverter~DomConverter#shouldRenderAttribute}) would filter them out.
-         *
-         * These attributes can be specified as an option when the element is created by
-         * the {@link module:engine/view/downcastwriter~DowncastWriter}. To check whether an unsafe an attribute should
-         * be permitted, use the {@link #shouldRenderUnsafeAttribute} method.
-         *
-         * @private
-         * @readonly
-         * @member {Array.<String>}
-         */
-        this._unsafeAttributesToRender = [];
     }
     /**
      * Number of element's children.
-     *
-     * @readonly
-     * @type {Number}
      */
     get childCount() {
         return this._children.length;
     }
     /**
      * Is `true` if there are no nodes inside this element, `false` otherwise.
-     *
-     * @readonly
-     * @type {Boolean}
      */
     get isEmpty() {
         return this._children.length === 0;
@@ -150,8 +107,8 @@ export default class Element extends Node {
     /**
      * Gets child at the given index.
      *
-     * @param {Number} index Index of child.
-     * @returns {module:engine/view/node~Node} Child node.
+     * @param index Index of child.
+     * @returns Child node.
      */
     getChild(index) {
         return this._children[index];
@@ -159,8 +116,8 @@ export default class Element extends Node {
     /**
      * Gets index of the given child node. Returns `-1` if child node is not found.
      *
-     * @param {module:engine/view/node~Node} node Child node.
-     * @returns {Number} Index of the child node.
+     * @param node Child node.
+     * @returns Index of the child node.
      */
     getChildIndex(node) {
         return this._children.indexOf(node);
@@ -168,7 +125,7 @@ export default class Element extends Node {
     /**
      * Gets child nodes iterator.
      *
-     * @returns {Iterable.<module:engine/view/node~Node>} Child nodes iterator.
+     * @returns Child nodes iterator.
      */
     getChildren() {
         return this._children[Symbol.iterator]();
@@ -176,7 +133,7 @@ export default class Element extends Node {
     /**
      * Returns an iterator that contains the keys for attributes. Order of inserting attributes is not preserved.
      *
-     * @returns {Iterable.<String>} Keys for attributes.
+     * @returns Keys for attributes.
      */
     *getAttributeKeys() {
         if (this._classes.size > 0) {
@@ -192,8 +149,6 @@ export default class Element extends Node {
      *
      * Attributes are returned as arrays containing two items. First one is attribute key and second is attribute value.
      * This format is accepted by native `Map` object and also can be passed in `Node` constructor.
-     *
-     * @returns {Iterable.<*>}
      */
     *getAttributes() {
         yield* this._attrs.entries();
@@ -207,8 +162,8 @@ export default class Element extends Node {
     /**
      * Gets attribute by key. If attribute is not present - returns undefined.
      *
-     * @param {String} key Attribute key.
-     * @returns {String|undefined} Attribute value.
+     * @param key Attribute key.
+     * @returns Attribute value.
      */
     getAttribute(key) {
         if (key == 'class') {
@@ -226,8 +181,8 @@ export default class Element extends Node {
     /**
      * Returns a boolean indicating whether an attribute with the specified key exists in the element.
      *
-     * @param {String} key Attribute key.
-     * @returns {Boolean} `true` if attribute with the specified key exists in the element, false otherwise.
+     * @param key Attribute key.
+     * @returns `true` if attribute with the specified key exists in the element, `false` otherwise.
      */
     hasAttribute(key) {
         if (key == 'class') {
@@ -242,9 +197,6 @@ export default class Element extends Node {
      * Checks if this element is similar to other element.
      * Both elements should have the same name and attributes to be considered as similar. Two similar elements
      * can contain different set of children nodes.
-     *
-     * @param {module:engine/view/element~Element} otherElement
-     * @returns {Boolean}
      */
     isSimilar(otherElement) {
         if (!(otherElement instanceof Element)) {
@@ -288,10 +240,10 @@ export default class Element extends Node {
      * Returns true if class is present.
      * If more then one class is provided - returns true only when all classes are present.
      *
-     *		element.hasClass( 'foo' ); // Returns true if 'foo' class is present.
-     *		element.hasClass( 'foo', 'bar' ); // Returns true if 'foo' and 'bar' classes are both present.
-     *
-     * @param {...String} className
+     * ```ts
+     * element.hasClass( 'foo' ); // Returns true if 'foo' class is present.
+     * element.hasClass( 'foo', 'bar' ); // Returns true if 'foo' and 'bar' classes are both present.
+     * ```
      */
     hasClass(...className) {
         for (const name of className) {
@@ -303,8 +255,6 @@ export default class Element extends Node {
     }
     /**
      * Returns iterator that contains all class names.
-     *
-     * @returns {Iterable.<String>}
      */
     getClassNames() {
         return this._classes.keys();
@@ -319,21 +269,20 @@ export default class Element extends Node {
      *
      * For an element with style set to `'margin:1px'`:
      *
-     *		// Enable 'margin' shorthand processing:
-     *		editor.data.addStyleProcessorRules( addMarginRules );
+     * ```ts
+     * // Enable 'margin' shorthand processing:
+     * editor.data.addStyleProcessorRules( addMarginRules );
      *
-     *		const element = view.change( writer => {
-     *			const element = writer.createElement();
-     *			writer.setStyle( 'margin', '1px' );
-     *			writer.setStyle( 'margin-bottom', '3em' );
+     * const element = view.change( writer => {
+     * 	const element = writer.createElement();
+     * 	writer.setStyle( 'margin', '1px' );
+     * 	writer.setStyle( 'margin-bottom', '3em' );
      *
-     *			return element;
-     *		} );
+     * 	return element;
+     * } );
      *
-     *		element.getStyle( 'margin' ); // -> 'margin: 1px 1px 3em;'
-     *
-     * @param {String} property
-     * @returns {String|undefined}
+     * element.getStyle( 'margin' ); // -> 'margin: 1px 1px 3em;'
+     * ```
      */
     getStyle(property) {
         return this._styles.getAsString(property);
@@ -343,20 +292,26 @@ export default class Element extends Node {
      *
      * For an element with style set to: margin:1px 2px 3em;
      *
-     *		element.getNormalizedStyle( 'margin' ) );
+     * ```ts
+     * element.getNormalizedStyle( 'margin' ) );
+     * ```
      *
      * will return:
      *
-     *		{
-     *			top: '1px',
-     *			right: '2px',
-     *			bottom: '3em',
-     *			left: '2px'    // a normalized value from margin shorthand
-     *		}
+     * ```ts
+     * {
+     * 	top: '1px',
+     * 	right: '2px',
+     * 	bottom: '3em',
+     * 	left: '2px'    // a normalized value from margin shorthand
+     * }
+     * ```
      *
      * and reading for single style value:
      *
-     *		styles.getNormalizedStyle( 'margin-left' );
+     * ```ts
+     * styles.getNormalizedStyle( 'margin-left' );
+     * ```
      *
      * Will return a `2px` string.
      *
@@ -364,9 +319,7 @@ export default class Element extends Node {
      * {@link module:engine/controller/datacontroller~DataController#addStyleProcessorRules a particular style processor rule is enabled}.
      * See {@link module:engine/view/stylesmap~StylesMap#getNormalized `StylesMap#getNormalized()`} for details.
      *
-     *
-     * @param {String} property Name of CSS property
-     * @returns {Object|String|undefined}
+     * @param property Name of CSS property
      */
     getNormalizedStyle(property) {
         return this._styles.getNormalized(property);
@@ -374,8 +327,7 @@ export default class Element extends Node {
     /**
      * Returns iterator that contains all style names.
      *
-     * @param {Boolean} [expand=false] Expand shorthand style properties and return all equivalent style representations.
-     * @returns {Iterable.<String>}
+     * @param expand Expand shorthand style properties and return all equivalent style representations.
      */
     getStyleNames(expand) {
         return this._styles.getStyleNames(expand);
@@ -384,10 +336,10 @@ export default class Element extends Node {
      * Returns true if style keys are present.
      * If more then one style property is provided - returns true only when all properties are present.
      *
-     *		element.hasStyle( 'color' ); // Returns true if 'border-top' style is present.
-     *		element.hasStyle( 'color', 'border-top' ); // Returns true if 'color' and 'border-top' styles are both present.
-     *
-     * @param {...String} property
+     * ```ts
+     * element.hasStyle( 'color' ); // Returns true if 'border-top' style is present.
+     * element.hasStyle( 'color', 'border-top' ); // Returns true if 'color' and 'border-top' styles are both present.
+     * ```
      */
     hasStyle(...property) {
         for (const name of property) {
@@ -402,9 +354,8 @@ export default class Element extends Node {
      * Provided patterns should be compatible with {@link module:engine/view/matcher~Matcher Matcher} as it is used internally.
      *
      * @see module:engine/view/matcher~Matcher
-     * @param {Object|String|RegExp|Function} patterns Patterns used to match correct ancestor.
-     * See {@link module:engine/view/matcher~Matcher}.
-     * @returns {module:engine/view/element~Element|null} Found element or `null` if no matching ancestor was found.
+     * @param patterns Patterns used to match correct ancestor. See {@link module:engine/view/matcher~Matcher}.
+     * @returns Found element or `null` if no matching ancestor was found.
      */
     findAncestor(...patterns) {
         const matcher = new Matcher(...patterns);
@@ -419,9 +370,6 @@ export default class Element extends Node {
     }
     /**
      * Returns the custom property value for the given key.
-     *
-     * @param {String|Symbol} key
-     * @returns {*}
      */
     getCustomProperty(key) {
         return this._customProperties.get(key);
@@ -429,8 +377,6 @@ export default class Element extends Node {
     /**
      * Returns an iterator which iterates over this element's custom properties.
      * Iterator provides `[ key, value ]` pairs for each stored property.
-     *
-     * @returns {Iterable.<*>}
      */
     *getCustomProperties() {
         yield* this._customProperties.entries();
@@ -440,23 +386,25 @@ export default class Element extends Node {
      * Two elements that {@link #isSimilar are similar} will have same identity string.
      * It has the following format:
      *
-     *		'name class="class1,class2" style="style1:value1;style2:value2" attr1="val1" attr2="val2"'
+     * ```ts
+     * 'name class="class1,class2" style="style1:value1;style2:value2" attr1="val1" attr2="val2"'
+     * ```
      *
      * For example:
      *
-     *		const element = writer.createContainerElement( 'foo', {
-     *			banana: '10',
-     *			apple: '20',
-     *			style: 'color: red; border-color: white;',
-     *			class: 'baz'
-     *		} );
+     * ```ts
+     * const element = writer.createContainerElement( 'foo', {
+     * 	banana: '10',
+     * 	apple: '20',
+     * 	style: 'color: red; border-color: white;',
+     * 	class: 'baz'
+     * } );
      *
-     *		// returns 'foo class="baz" style="border-color:white;color:red" apple="20" banana="10"'
-     *		element.getIdentity();
+     * // returns 'foo class="baz" style="border-color:white;color:red" apple="20" banana="10"'
+     * element.getIdentity();
+     * ```
      *
      * **Note**: Classes, styles and other attributes are sorted alphabetically.
-     *
-     * @returns {String}
      */
     getIdentity() {
         const classes = Array.from(this._classes).sort().join(',');
@@ -473,8 +421,7 @@ export default class Element extends Node {
      *
      * Unsafe attribute names can be specified when creating an element via {@link module:engine/view/downcastwriter~DowncastWriter}.
      *
-     * @param {String} attributeName The name of the attribute to be checked.
-     * @returns {Boolean}
+     * @param attributeName The name of the attribute to be checked.
      */
     shouldRenderUnsafeAttribute(attributeName) {
         return this._unsafeAttributesToRender.includes(attributeName);
@@ -482,10 +429,10 @@ export default class Element extends Node {
     /**
      * Clones provided element.
      *
-     * @protected
-     * @param {Boolean} [deep=false] If set to `true` clones element and all its children recursively. When set to `false`,
+     * @internal
+     * @param deep If set to `true` clones element and all its children recursively. When set to `false`,
      * element will be cloned without any children.
-     * @returns {module:engine/view/element~Element} Clone of this element.
+     * @returns Clone of this element.
      */
     _clone(deep = false) {
         const childrenClone = [];
@@ -515,10 +462,10 @@ export default class Element extends Node {
      * and sets the parent of these nodes to this element.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#insert
-     * @protected
-     * @param {module:engine/view/item~Item|Iterable.<module:engine/view/item~Item>} items Items to be inserted.
-     * @fires module:engine/view/node~Node#change
-     * @returns {Number} Number of appended nodes.
+     * @internal
+     * @param items Items to be inserted.
+     * @fires change
+     * @returns Number of appended nodes.
      */
     _appendChild(items) {
         return this._insertChild(this.childCount, items);
@@ -529,11 +476,10 @@ export default class Element extends Node {
      *
      * @internal
      * @see module:engine/view/downcastwriter~DowncastWriter#insert
-     * @protected
-     * @param {Number} index Position where nodes should be inserted.
-     * @param {module:engine/view/item~Item|Iterable.<module:engine/view/item~Item>} items Items to be inserted.
-     * @fires module:engine/view/node~Node#change
-     * @returns {Number} Number of inserted nodes.
+     * @param index Position where nodes should be inserted.
+     * @param items Items to be inserted.
+     * @fires change
+     * @returns Number of inserted nodes.
      */
     _insertChild(index, items) {
         this._fireChange('children', this);
@@ -556,11 +502,11 @@ export default class Element extends Node {
      * Removes number of child nodes starting at the given index and set the parent of these nodes to `null`.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#remove
-     * @protected
-     * @param {Number} index Number of the first node to remove.
-     * @param {Number} [howMany=1] Number of nodes to remove.
-     * @fires module:engine/view/node~Node#change
-     * @returns {Array.<module:engine/view/node~Node>} The array of removed nodes.
+     * @internal
+     * @param index Number of the first node to remove.
+     * @param howMany Number of nodes to remove.
+     * @fires change
+     * @returns The array of removed nodes.
      */
     _removeChildren(index, howMany = 1) {
         this._fireChange('children', this);
@@ -573,10 +519,10 @@ export default class Element extends Node {
      * Adds or overwrite attribute with a specified key and value.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#setAttribute
-     * @protected
-     * @param {String} key Attribute key.
-     * @param {String} value Attribute value.
-     * @fires module:engine/view/node~Node#change
+     * @internal
+     * @param key Attribute key.
+     * @param value Attribute value.
+     * @fires change
      */
     _setAttribute(key, value) {
         const stringValue = String(value);
@@ -595,10 +541,10 @@ export default class Element extends Node {
      * Removes attribute from the element.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#removeAttribute
-     * @protected
-     * @param {String} key Attribute key.
-     * @returns {Boolean} Returns true if an attribute existed and has been removed.
-     * @fires module:engine/view/node~Node#change
+     * @internal
+     * @param key Attribute key.
+     * @returns Returns true if an attribute existed and has been removed.
+     * @fires change
      */
     _removeAttribute(key) {
         this._fireChange('attributes', this);
@@ -624,13 +570,14 @@ export default class Element extends Node {
     /**
      * Adds specified class.
      *
-     *		element._addClass( 'foo' ); // Adds 'foo' class.
-     *		element._addClass( [ 'foo', 'bar' ] ); // Adds 'foo' and 'bar' classes.
+     * ```ts
+     * element._addClass( 'foo' ); // Adds 'foo' class.
+     * element._addClass( [ 'foo', 'bar' ] ); // Adds 'foo' and 'bar' classes.
+     * ```
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#addClass
-     * @protected
-     * @param {Array.<String>|String} className
-     * @fires module:engine/view/node~Node#change
+     * @internal
+     * @fires change
      */
     _addClass(className) {
         this._fireChange('attributes', this);
@@ -641,13 +588,14 @@ export default class Element extends Node {
     /**
      * Removes specified class.
      *
-     *		element._removeClass( 'foo' );  // Removes 'foo' class.
-     *		element._removeClass( [ 'foo', 'bar' ] ); // Removes both 'foo' and 'bar' classes.
+     * ```ts
+     * element._removeClass( 'foo' );  // Removes 'foo' class.
+     * element._removeClass( [ 'foo', 'bar' ] ); // Removes both 'foo' and 'bar' classes.
+     * ```
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#removeClass
-     * @protected
-     * @param {Array.<String>|String} className
-     * @fires module:engine/view/node~Node#change
+     * @internal
+     * @fires change
      */
     _removeClass(className) {
         this._fireChange('attributes', this);
@@ -657,7 +605,7 @@ export default class Element extends Node {
     }
     _setStyle(property, value) {
         this._fireChange('attributes', this);
-        if (isPlainObject(property)) {
+        if (typeof property != 'string') {
             this._styles.set(property);
         }
         else {
@@ -667,17 +615,18 @@ export default class Element extends Node {
     /**
      * Removes specified style.
      *
-     *		element._removeStyle( 'color' );  // Removes 'color' style.
-     *		element._removeStyle( [ 'color', 'border-top' ] ); // Removes both 'color' and 'border-top' styles.
+     * ```ts
+     * element._removeStyle( 'color' );  // Removes 'color' style.
+     * element._removeStyle( [ 'color', 'border-top' ] ); // Removes both 'color' and 'border-top' styles.
+     * ```
      *
      * **Note**: This method can work with normalized style names if
      * {@link module:engine/controller/datacontroller~DataController#addStyleProcessorRules a particular style processor rule is enabled}.
      * See {@link module:engine/view/stylesmap~StylesMap#remove `StylesMap#remove()`} for details.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#removeStyle
-     * @protected
-     * @param {Array.<String>|String} property
-     * @fires module:engine/view/node~Node#change
+     * @internal
+     * @fires change
      */
     _removeStyle(property) {
         this._fireChange('attributes', this);
@@ -690,9 +639,7 @@ export default class Element extends Node {
      * so they can be used to add special data to elements.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#setCustomProperty
-     * @protected
-     * @param {String|Symbol} key
-     * @param {*} value
+     * @internal
      */
     _setCustomProperty(key, value) {
         this._customProperties.set(key, value);
@@ -701,37 +648,15 @@ export default class Element extends Node {
      * Removes the custom property stored under the given key.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#removeCustomProperty
-     * @protected
-     * @param {String|Symbol} key
-     * @returns {Boolean} Returns true if property was removed.
+     * @internal
+     * @returns Returns true if property was removed.
      */
     _removeCustomProperty(key) {
         return this._customProperties.delete(key);
     }
 }
-/**
- * Checks whether this object is of the given.
- *
- *		element.is( 'element' ); // -> true
- *		element.is( 'node' ); // -> true
- *		element.is( 'view:element' ); // -> true
- *		element.is( 'view:node' ); // -> true
- *
- *		element.is( 'model:element' ); // -> false
- *		element.is( 'documentSelection' ); // -> false
- *
- * Assuming that the object being checked is an element, you can also check its
- * {@link module:engine/view/element~Element#name name}:
- *
- *		element.is( 'element', 'img' ); // -> true if this is an <img> element
- *		text.is( 'element', 'img' ); -> false
- *
- * {@link module:engine/view/node~Node#is Check the entire list of view objects} which implement the `is()` method.
- *
- * @param {String} type Type to check.
- * @param {String} [name] Element name.
- * @returns {Boolean}
- */
+// The magic of type inference using `is` method is centralized in `TypeCheckable` class.
+// Proper overload would interfere with that.
 Element.prototype.is = function (type, name) {
     if (!name) {
         return type === 'element' || type === 'view:element' ||
@@ -742,12 +667,14 @@ Element.prototype.is = function (type, name) {
         return name === this.name && (type === 'element' || type === 'view:element');
     }
 };
-// Parses attributes provided to the element constructor before they are applied to an element. If attributes are passed
-// as an object (instead of `Iterable`), the object is transformed to the map. Attributes with `null` value are removed.
-// Attributes with non-`String` value are converted to `String`.
-//
-// @param {Object|Iterable} attrs Attributes to parse.
-// @returns {Map} Parsed attributes.
+/**
+ * Parses attributes provided to the element constructor before they are applied to an element. If attributes are passed
+ * as an object (instead of `Iterable`), the object is transformed to the map. Attributes with `null` value are removed.
+ * Attributes with non-`String` value are converted to `String`.
+ *
+ * @param attrs Attributes to parse.
+ * @returns Parsed attributes.
+ */
 function parseAttributes(attrs) {
     const attrsMap = toMap(attrs);
     for (const [key, value] of attrsMap) {
@@ -760,20 +687,21 @@ function parseAttributes(attrs) {
     }
     return attrsMap;
 }
-// Parses class attribute and puts all classes into classes set.
-// Classes set s cleared before insertion.
-//
-// @param {Set.<String>} classesSet Set to insert parsed classes.
-// @param {String} classesString String with classes to parse.
+/**
+ * Parses class attribute and puts all classes into classes set.
+ * Classes set s cleared before insertion.
+ *
+ * @param classesSet Set to insert parsed classes.
+ * @param classesString String with classes to parse.
+ */
 function parseClasses(classesSet, classesString) {
     const classArray = classesString.split(/\s+/);
     classesSet.clear();
     classArray.forEach(name => classesSet.add(name));
 }
-// Converts strings to Text and non-iterables to arrays.
-//
-// @param {String|module:engine/view/item~Item|Iterable.<String|module:engine/view/item~Item>}
-// @returns {Iterable.<module:engine/view/node~Node>}
+/**
+ * Converts strings to Text and non-iterables to arrays.
+ */
 function normalize(document, nodes) {
     // Separate condition because string is iterable.
     if (typeof nodes == 'string') {