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

package/src/model/typecheckable.d.ts

@@ -47,6 +47,8 @@ export default abstract class TypeCheckable {
      * imageElement.is( 'element', 'imageBlock' ); // -> same as above
      * imageElement.is( 'model:element', 'imageBlock' ); // -> same as above, but more precise
      * ```
+     *
+     * @label NODE
      */
     is(type: 'node' | 'model:node'): this is Node | Element | Text | RootElement;
     /**
@@ -69,6 +71,8 @@ export default abstract class TypeCheckable {
      * element.is( 'element', 'imageBlock' ); // -> true if this is an <imageBlock> element
      * text.is( 'element', 'imageBlock' ); -> false
      * ```
+     *
+     * @label ELEMENT
      */
     is(type: 'element' | 'model:element'): this is Element | RootElement;
     /**
@@ -92,6 +96,8 @@ export default abstract class TypeCheckable {
      * ```ts
      * rootElement.is( 'rootElement', '$root' ); // -> same as above
      * ```
+     *
+     * @label ROOT_ELEMENT
      */
     is(type: 'rootElement' | 'model:rootElement'): this is RootElement;
     /**
@@ -109,6 +115,8 @@ export default abstract class TypeCheckable {
      *
      * **Note:** Until version 20.0.0 this method wasn't accepting `'$text'` type. The legacy `'text'` type is still
      * accepted for backward compatibility.
+     *
+     * @label TEXT
      */
     is(type: '$text' | 'model:$text'): this is Text;
     /**
@@ -121,6 +129,8 @@ export default abstract class TypeCheckable {
      * position.is( 'view:position' ); // -> false
      * position.is( 'documentSelection' ); // -> false
      * ```
+     *
+     * @label POSITION
      */
     is(type: 'position' | 'model:position'): this is Position | LivePosition;
     /**
@@ -135,6 +145,8 @@ export default abstract class TypeCheckable {
      * livePosition.is( 'view:position' ); // -> false
      * livePosition.is( 'documentSelection' ); // -> false
      * ```
+     *
+     * @label LIVE_POSITION
      */
     is(type: 'livePosition' | 'model:livePosition'): this is LivePosition;
     /**
@@ -147,6 +159,8 @@ export default abstract class TypeCheckable {
      * range.is( 'view:range' ); // -> false
      * range.is( 'documentSelection' ); // -> false
      * ```
+     *
+     * @label RANGE
      */
     is(type: 'range' | 'model:range'): this is Range | LiveRange;
     /**
@@ -161,6 +175,8 @@ export default abstract class TypeCheckable {
      * liveRange.is( 'view:range' ); // -> false
      * liveRange.is( 'documentSelection' ); // -> false
      * ```
+     *
+     * @label LIVE_RANGE
      */
     is(type: 'liveRange' | 'model:liveRange'): this is LiveRange;
     /**
@@ -174,6 +190,8 @@ export default abstract class TypeCheckable {
      * docFrag.is( 'element' ); // -> false
      * docFrag.is( 'node' ); // -> false
      * ```
+     *
+     * @label DOCUMENT_FRAGMENT
      */
     is(type: 'documentFragment' | 'model:documentFragment'): this is DocumentFragment;
     /**
@@ -187,6 +205,8 @@ export default abstract class TypeCheckable {
      * selection.is( 'view:selection' ); // -> false
      * selection.is( 'range' ); // -> false
      * ```
+     *
+     * @label SELECTION
      */
     is(type: 'selection' | 'model:selection'): this is Selection | DocumentSelection;
     /**
@@ -202,10 +222,12 @@ export default abstract class TypeCheckable {
      * selection.is( 'element' ); // -> false
      * selection.is( 'node' ); // -> false
      * ```
+     *
+     * @label DOCUMENT_SELECTION
      */
     is(type: 'documentSelection' | 'model:documentSelection'): this is DocumentSelection;
     /**
-     * Checks whether the object is of type {@link module:engine/model/marker~Marker}.
+     * Checks whether the object is of type {@link module:engine/model/markercollection~Marker}.
      *
      * ```ts
      * marker.is( 'marker' ); // -> true
@@ -214,6 +236,8 @@ export default abstract class TypeCheckable {
      * marker.is( 'view:element' ); // -> false
      * marker.is( 'documentSelection' ); // -> false
      * ```
+     *
+     * @label MARKER
      */
     is(type: 'marker' | 'model:marker'): this is Marker;
     /**
@@ -229,6 +253,8 @@ export default abstract class TypeCheckable {
      *
      * **Note:** Until version 20.0.0 this method wasn't accepting `'$textProxy'` type. The legacy `'textProxt'` type is still
      * accepted for backward compatibility.
+     *
+     * @label TEXT_PROXY
      */
     is(type: '$textProxy' | 'model:$textProxy'): this is TextProxy;
     /**
@@ -238,6 +264,8 @@ export default abstract class TypeCheckable {
      * element.is( 'element', 'imageBlock' ); // -> true if this is an <imageBlock> element
      * text.is( 'element', 'imageBlock' ); -> false
      * ```
+     *
+     * @label ELEMENT_NAME
      */
     is<N extends string>(type: 'element' | 'model:element', name: N): this is (Element | RootElement) & {
         name: N;
@@ -248,6 +276,8 @@ export default abstract class TypeCheckable {
      * ```ts
      * rootElement.is( 'rootElement', '$root' );
      * ```
+     *
+     * @label ROOT_ELEMENT_NAME
      */
     is<N extends string>(type: 'rootElement' | 'model:rootElement', name: N): this is RootElement & {
         name: N;

package/src/model/writer.d.ts

@@ -162,6 +162,7 @@ export default class Writer {
      *
      * These parameters work in the same way as {@link #createPositionAt `writer.createPositionAt()`}.
      *
+     * @label WITHOUT_ATTRIBUTES
      * @param text Text data.
      * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~Item model item}.
      */
@@ -187,11 +188,12 @@ export default class Writer {
      *
      * These parameters work in the same way as {@link #createPositionAt `writer.createPositionAt()`}.
      *
+     * @label WITH_ATTRIBUTES
      * @param text Text data.
      * @param attributes Text attributes.
      * @param offset Offset or one of the flags. Used only when third parameter is a {@link module:engine/model/item~Item model item}.
      */
-    insertText(text: string, attributes?: NodeAttributes, itemOrPosition?: Item | Position, offset?: number | 'end' | 'before' | 'after'): void;
+    insertText(text: string, attributes?: NodeAttributes, itemOrPosition?: Item | Position, offset?: PositionOffset): void;
     /**
      * Creates and inserts element on given position. You can optionally set attributes:
      *
@@ -213,10 +215,11 @@ export default class Writer {
      *
      * These parameters works the same way as {@link #createPositionAt `writer.createPositionAt()`}.
      *
+     * @label WITHOUT_ATTRIBUTES
      * @param name Name of the element.
      * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~Item model item}.
      */
-    insertElement(name: string, itemOrPosition: Item | DocumentFragment | Position, offset?: number | 'end' | 'before' | 'after'): void;
+    insertElement(name: string, itemOrPosition: Item | DocumentFragment | Position, offset?: PositionOffset): void;
     /**
      * Creates and inserts element with specified attributes on given position.
      *
@@ -238,11 +241,12 @@ export default class Writer {
      *
      * These parameters works the same way as {@link #createPositionAt `writer.createPositionAt()`}.
      *
+     * @label WITH_ATTRIBUTES
      * @param name Name of the element.
      * @param attributes Elements attributes.
      * @param offset Offset or one of the flags. Used only when third parameter is a {@link module:engine/model/item~Item model item}.
      */
-    insertElement(name: string, attributes: NodeAttributes, itemOrPosition: Item | DocumentFragment | Position, offset?: number | 'end' | 'before' | 'after'): void;
+    insertElement(name: string, attributes: NodeAttributes, itemOrPosition: Item | DocumentFragment | Position, offset?: PositionOffset): void;
     /**
      * Inserts item at the end of the given parent.
      *
@@ -266,6 +270,7 @@ export default class Writer {
      * writer.appendText( 'foo', paragraph );
      * ```
      *
+     * @label WITHOUT_ATTRIBUTES
      * @param text Text data.
      */
     appendText(text: string, parent: Element | DocumentFragment): void;
@@ -276,6 +281,7 @@ export default class Writer {
      * writer.appendText( 'foo', { bold: true }, paragraph );
      * ```
      *
+     * @label WITH_ATTRIBUTES
      * @param text Text data.
      * @param attributes Text attributes.
      */
@@ -287,6 +293,7 @@ export default class Writer {
      * writer.appendElement( 'paragraph', root );
      * ```
      *
+     * @label WITHOUT_ATTRIBUTES
      * @param name Name of the element.
      */
     appendElement(name: string, parent: Element | DocumentFragment): void;
@@ -297,6 +304,7 @@ export default class Writer {
      * writer.appendElement( 'paragraph', { alignment: 'center' }, root );
      * ```
      *
+     * @label WITH_ATTRIBUTES
      * @param name Name of the element.
      * @param attributes Elements attributes.
      */
@@ -429,9 +437,19 @@ export default class Writer {
      * @param element Element which is a parent for the range.
      */
     createRangeOn(element: Item): Range;
+    /**
+     * Shortcut for {@link module:engine/model/model~Model#createSelection:NODE_OFFSET `Model#createSelection()`}.
+     *
+     * @label NODE_OFFSET
+     */
     createSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: {
         backward?: boolean;
     }): Selection;
+    /**
+     * Shortcut for {@link module:engine/model/model~Model#createSelection:SELECTABLE `Model#createSelection()`}.
+     *
+     * @label SELECTABLE
+     */
     createSelection(selectable?: Exclude<Selectable, Node>, options?: {
         backward?: boolean;
     }): Selection;
@@ -605,9 +623,86 @@ export default class Writer {
      * @param markerOrName Marker or marker name to remove.
      */
     removeMarker(markerOrName: string | Marker): void;
+    /**
+     * Sets the document's selection (ranges and direction) to the specified location based on the given
+     * {@link module:engine/model/selection~Selectable selectable} or creates an empty selection if no arguments were passed.
+     *
+     * ```ts
+     * // Sets collapsed selection at the position of the given node and an offset.
+     * writer.setSelection( paragraph, offset );
+     * ```
+     *
+     * Creates a range inside an {@link module:engine/model/element~Element element} which starts before the first child of
+     * that element and ends after the last child of that element.
+     *
+     * ```ts
+     * writer.setSelection( paragraph, 'in' );
+     * ```
+     *
+     * Creates a range on an {@link module:engine/model/item~Item item} which starts before the item and ends just after the item.
+     *
+     * ```ts
+     * writer.setSelection( paragraph, 'on' );
+     * ```
+     *
+     * `Writer#setSelection()` allow passing additional options (`backward`) as the last argument.
+     *
+     * ```ts
+     * // Sets selection as backward.
+     * writer.setSelection( element, 'in', { backward: true } );
+     * ```
+     *
+     * Throws `writer-incorrect-use` error when the writer is used outside the `change()` block.
+     *
+     * See also: {@link #setSelection:SELECTABLE `setSelection( selectable, options )`}.
+     *
+     * @label NODE_OFFSET
+     */
     setSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: {
         backward?: boolean;
     }): void;
+    /**
+     * Sets the document's selection (ranges and direction) to the specified location based on the given
+     * {@link module:engine/model/selection~Selectable selectable} or creates an empty selection if no arguments were passed.
+     *
+     * ```ts
+     * // Sets selection to the given range.
+     * const range = writer.createRange( start, end );
+     * writer.setSelection( range );
+     *
+     * // Sets selection to given ranges.
+     * const ranges = [ writer.createRange( start1, end2 ), writer.createRange( star2, end2 ) ];
+     * writer.setSelection( ranges );
+     *
+     * // Sets selection to other selection.
+     * const otherSelection = writer.createSelection();
+     * writer.setSelection( otherSelection );
+     *
+     * // Sets selection to the given document selection.
+     * const documentSelection = model.document.selection;
+     * writer.setSelection( documentSelection );
+     *
+     * // Sets collapsed selection at the given position.
+     * const position = writer.createPosition( root, path );
+     * writer.setSelection( position );
+     *
+     * // Removes all selection's ranges.
+     * writer.setSelection( null );
+     * ```
+     *
+     * `Writer#setSelection()` allow passing additional options (`backward`) as the last argument.
+     *
+     * ```ts
+     * // Sets selection as backward.
+     * writer.setSelection( range, { backward: true } );
+     * ```
+     *
+     * Throws `writer-incorrect-use` error when the writer is used outside the `change()` block.
+     *
+     * See also: {@link #setSelection:NODE_OFFSET `setSelection( node, placeOrOffset, options )`}.
+     *
+     * @label SELECTABLE
+     */
     setSelection(selectable: Exclude<Selectable, Node>, options?: {
         backward?: boolean;
     }): void;
@@ -628,6 +723,7 @@ export default class Writer {
      * writer.setSelectionAttribute( 'italic', true );
      * ```
      *
+     * @label KEY_VALUE
      * @param key Key of the attribute to set.
      * @param value Attribute value.
      */
@@ -647,6 +743,7 @@ export default class Writer {
      * writer.setSelectionAttribute( new Map( [ [ 'italic', true ] ] ) );
      * ```
      *
+     * @label OBJECT
      * @param objectOrIterable Object / iterable of key => value attribute pairs.
      */
     setSelectionAttribute(objectOrIterable: NodeAttributes): void;

package/src/model/writer.js

@@ -521,9 +521,6 @@ export default class Writer {
     createRangeOn(element) {
         return this.model.createRangeOn(element);
     }
-    /**
-     * Shortcut for {@link module:engine/model/model~Model#createSelection `Model#createSelection()`}.
-     */
     createSelection(...args) {
         return this.model.createSelection(...args);
     }
@@ -920,60 +917,6 @@ export default class Writer {
         const oldRange = marker.getRange();
         applyMarkerOperation(this, name, oldRange, null, marker.affectsData);
     }
-    /**
-     * Sets the document's selection (ranges and direction) to the specified location based on the given
-     * {@link module:engine/model/selection~Selectable selectable} or creates an empty selection if no arguments were passed.
-     *
-     * ```ts
-     * // Sets selection to the given range.
-     * const range = writer.createRange( start, end );
-     * writer.setSelection( range );
-     *
-     * // Sets selection to given ranges.
-     * const ranges = [ writer.createRange( start1, end2 ), writer.createRange( star2, end2 ) ];
-     * writer.setSelection( ranges );
-     *
-     * // Sets selection to other selection.
-     * const otherSelection = writer.createSelection();
-     * writer.setSelection( otherSelection );
-     *
-     * // Sets selection to the given document selection.
-     * const documentSelection = model.document.selection;
-     * writer.setSelection( documentSelection );
-     *
-     * // Sets collapsed selection at the given position.
-     * const position = writer.createPosition( root, path );
-     * writer.setSelection( position );
-     *
-     * // Sets collapsed selection at the position of the given node and an offset.
-     * writer.setSelection( paragraph, offset );
-     * ```
-     *
-     * Creates a range inside an {@link module:engine/model/element~Element element} which starts before the first child of
-     * that element and ends after the last child of that element.
-     *
-     * ```ts
-     * writer.setSelection( paragraph, 'in' );
-     * ```
-     *
-     * Creates a range on an {@link module:engine/model/item~Item item} which starts before the item and ends just after the item.
-     *
-     * ```ts
-     * writer.setSelection( paragraph, 'on' );
-     *
-     * // Removes all selection's ranges.
-     * writer.setSelection( null );
-     * ```
-     *
-     * `Writer#setSelection()` allow passing additional options (`backward`) as the last argument.
-     *
-     * ```ts
-     * // Sets selection as backward.
-     * writer.setSelection( range, { backward: true } );
-     * ```
-     *
-     * Throws `writer-incorrect-use` error when the writer is used outside the `change()` block.
-     */
     setSelection(...args) {
         this._assertWriterUsedCorrectly();
         this.model.document.selection._setTo(...args);

package/src/view/document.d.ts

@@ -175,7 +175,7 @@ export type ChangeType = 'children' | 'attributes' | 'text';
  * {@link module:engine/view/view~View#event:render rendered}, but should be also fired by observers in case of
  * other actions which may change layout, for instance when image loads.
  *
- * @eventName layoutChanged
+ * @eventName ~Document#layoutChanged
  */
 export type ViewDocumentLayoutChangedEvent = {
     name: 'layoutChanged';

package/src/view/documentfragment.d.ts

@@ -128,7 +128,6 @@ export default class DocumentFragment extends DocumentFragment_base implements I
      * @internal
      * @param type Type of the change.
      * @param node Changed node.
-     * @fires change
      */
     _fireChange(type: ChangeType, node: Node | DocumentFragment): void;
     /**

package/src/view/documentfragment.js

@@ -174,7 +174,6 @@ export default class DocumentFragment extends EmitterMixin(TypeCheckable) {
      * @internal
      * @param type Type of the change.
      * @param node Changed node.
-     * @fires change
      */
     _fireChange(type, node) {
         this.fire('change:' + type, node);

package/src/view/documentselection.d.ts

@@ -29,7 +29,94 @@ export default class DocumentSelection extends DocumentSelection_base {
      * Selection is used internally (`DocumentSelection` is a proxy to that selection).
      */
     private readonly _selection;
+    /**
+     * Creates new DocumentSelection instance.
+     *
+     * ```ts
+     * // Creates collapsed selection at the position of given item and offset.
+     * const paragraph = writer.createContainerElement( 'paragraph' );
+     * const selection = new DocumentSelection( paragraph, offset );
+     *
+     * // Creates a range inside an {@link module:engine/view/element~Element element} which starts before the
+     * // first child of that element and ends after the last child of that element.
+     * const selection = new DocumentSelection( paragraph, 'in' );
+     *
+     * // Creates a range on an {@link module:engine/view/item~Item item} which starts before the item and ends
+     * // just after the item.
+     * const selection = new DocumentSelection( paragraph, 'on' );
+     * ```
+     *
+     * `Selection`'s constructor allow passing additional options (`backward`, `fake` and `label`) as the last argument.
+     *
+     * ```ts
+     * // Creates backward selection.
+     * const selection = new DocumentSelection( element, 'in', { backward: true } );
+     * ```
+     *
+     * Fake selection does not render as browser native selection over selected elements and is hidden to the user.
+     * This way, no native selection UI artifacts are displayed to the user and selection over elements can be
+     * represented in other way, for example by applying proper CSS class.
+     *
+     * Additionally fake's selection label can be provided. It will be used to describe fake selection in DOM
+     * (and be  properly handled by screen readers).
+     *
+     * ```ts
+     * // Creates fake selection with label.
+     * const selection = new DocumentSelection( element, 'in', { fake: true, label: 'foo' } );
+     * ```
+     *
+     * See also: {@link #constructor:SELECTABLE `constructor( selectable, options )`}.
+     *
+     * @label NODE_OFFSET
+     */
     constructor(selectable: Node, placeOrOffset: PlaceOrOffset, options?: SelectionOptions);
+    /**
+     * Creates new DocumentSelection instance.
+     *
+     * ```ts
+     * // Creates empty selection without ranges.
+     * const selection = new DocumentSelection();
+     *
+     * // Creates selection at the given range.
+     * const range = writer.createRange( start, end );
+     * const selection = new DocumentSelection( range );
+     *
+     * // Creates selection at the given ranges
+     * const ranges = [ writer.createRange( start1, end2 ), writer.createRange( start2, end2 ) ];
+     * const selection = new DocumentSelection( ranges );
+     *
+     * // Creates selection from the other selection.
+     * const otherSelection = writer.createSelection();
+     * const selection = new DocumentSelection( otherSelection );
+     *
+     * // Creates selection at the given position.
+     * const position = writer.createPositionAt( root, offset );
+     * const selection = new DocumentSelection( position );
+     * ```
+     *
+     * `Selection`'s constructor allow passing additional options (`backward`, `fake` and `label`) as the last argument.
+     *
+     * ```ts
+     * // Creates backward selection.
+     * const selection = new DocumentSelection( range, { backward: true } );
+     * ```
+     *
+     * Fake selection does not render as browser native selection over selected elements and is hidden to the user.
+     * This way, no native selection UI artifacts are displayed to the user and selection over elements can be
+     * represented in other way, for example by applying proper CSS class.
+     *
+     * Additionally fake's selection label can be provided. It will be used to describe fake selection in DOM
+     * (and be  properly handled by screen readers).
+     *
+     * ```ts
+     * // Creates fake selection with label.
+     * const selection = new DocumentSelection( range, { fake: true, label: 'foo' } );
+     * ```
+     *
+     * See also: {@link #constructor:NODE_OFFSET `constructor( node, placeOrOffset, options )`}.
+     *
+     * @label SELECTABLE
+     */
     constructor(selectable?: Exclude<Selectable, Node>, options?: SelectionOptions);
     /**
      * Returns true if selection instance is marked as `fake`.
@@ -213,7 +300,7 @@ export default class DocumentSelection extends DocumentSelection_base {
 /**
  * Fired whenever selection ranges are changed through {@link ~DocumentSelection Selection API}.
  *
- * @eventName change
+ * @eventName ~DocumentSelection#change
  */
 export type ViewDocumentSelectionChangeEvent = ViewSelectionChangeEvent;
 export {};

package/src/view/documentselection.js

@@ -19,61 +19,6 @@ import { EmitterMixin } from '@ckeditor/ckeditor5-utils';
  * (so via {@link module:engine/view/downcastwriter~DowncastWriter#setSelection `DowncastWriter#setSelection()`}).
  */
 export default class DocumentSelection extends EmitterMixin(TypeCheckable) {
-    /**
-     * Creates new DocumentSelection instance.
-     *
-     * ```ts
-     * // Creates empty selection without ranges.
-     * const selection = new DocumentSelection();
-     *
-     * // Creates selection at the given range.
-     * const range = writer.createRange( start, end );
-     * const selection = new DocumentSelection( range );
-     *
-     * // Creates selection at the given ranges
-     * const ranges = [ writer.createRange( start1, end2 ), writer.createRange( start2, end2 ) ];
-     * const selection = new DocumentSelection( ranges );
-     *
-     * // Creates selection from the other selection.
-     * const otherSelection = writer.createSelection();
-     * const selection = new DocumentSelection( otherSelection );
-     *
-     * // Creates selection at the given position.
-     * const position = writer.createPositionAt( root, offset );
-     * const selection = new DocumentSelection( position );
-     *
-     * // Creates collapsed selection at the position of given item and offset.
-     * const paragraph = writer.createContainerElement( 'paragraph' );
-     * const selection = new DocumentSelection( paragraph, offset );
-     *
-     * // Creates a range inside an {@link module:engine/view/element~Element element} which starts before the
-     * // first child of that element and ends after the last child of that element.
-     * const selection = new DocumentSelection( paragraph, 'in' );
-     *
-     * // Creates a range on an {@link module:engine/view/item~Item item} which starts before the item and ends
-     * // just after the item.
-     * const selection = new DocumentSelection( paragraph, 'on' );
-     * ```
-     *
-     * `Selection`'s constructor allow passing additional options (`backward`, `fake` and `label`) as the last argument.
-     *
-     * ```ts
-     * // Creates backward selection.
-     * const selection = new DocumentSelection( range, { backward: true } );
-     * ```
-     *
-     * Fake selection does not render as browser native selection over selected elements and is hidden to the user.
-     * This way, no native selection UI artifacts are displayed to the user and selection over elements can be
-     * represented in other way, for example by applying proper CSS class.
-     *
-     * Additionally fake's selection label can be provided. It will be used to describe fake selection in DOM
-     * (and be  properly handled by screen readers).
-     *
-     * ```ts
-     * // Creates fake selection with label.
-     * const selection = new DocumentSelection( range, { fake: true, label: 'foo' } );
-     * ```
-     */
     constructor(...args) {
         super();
         this._selection = new Selection();

package/src/view/domconverter.d.ts

@@ -338,8 +338,38 @@ export default class DomConverter {
      * @returns Corresponding view text node or `null`, if it was not possible to find a corresponding node.
      */
     findCorrespondingViewText(domText: DomText): ViewText | ViewUIElement | ViewRawElement | null;
+    /**
+     * Returns corresponding DOM item for provided {@link module:engine/view/element~Element Element} or
+     * {@link module:engine/view/documentfragment~DocumentFragment DocumentFragment}.
+     * To find a corresponding text for {@link module:engine/view/text~Text view Text instance}
+     * use {@link #findCorrespondingDomText}.
+     *
+     * @label ELEMENT
+     * @param element View element or document fragment.
+     * @returns Corresponding DOM node or document fragment.
+     */
     mapViewToDom(element: ViewElement): DomElement | undefined;
+    /**
+     * Returns corresponding DOM item for provided {@link module:engine/view/element~Element Element} or
+     * {@link module:engine/view/documentfragment~DocumentFragment DocumentFragment}.
+     * To find a corresponding text for {@link module:engine/view/text~Text view Text instance}
+     * use {@link #findCorrespondingDomText}.
+     *
+     * @label DOCUMENT_FRAGMENT
+     * @param documentFragment View element or document fragment.
+     * @returns Corresponding DOM node or document fragment.
+     */
     mapViewToDom(documentFragment: ViewDocumentFragment): DomDocumentFragment | undefined;
+    /**
+     * Returns corresponding DOM item for provided {@link module:engine/view/element~Element Element} or
+     * {@link module:engine/view/documentfragment~DocumentFragment DocumentFragment}.
+     * To find a corresponding text for {@link module:engine/view/text~Text view Text instance}
+     * use {@link #findCorrespondingDomText}.
+     *
+     * @label DOCUMENT_FRAGMENT_OR_ELEMENT
+     * @param documentFragmentOrElement View element or document fragment.
+     * @returns Corresponding DOM node or document fragment.
+     */
     mapViewToDom(documentFragmentOrElement: ViewElement | ViewDocumentFragment): DomElement | DomDocumentFragment | undefined;
     /**
      * Finds corresponding text node. Text nodes are not {@link module:engine/view/domconverter~DomConverter#bindElements bound},

package/src/view/domconverter.js

@@ -735,15 +735,6 @@ export default class DomConverter {
         }
         return null;
     }
-    /**
-     * Returns corresponding DOM item for provided {@link module:engine/view/element~Element Element} or
-     * {@link module:engine/view/documentfragment~DocumentFragment DocumentFragment}.
-     * To find a corresponding text for {@link module:engine/view/text~Text view Text instance}
-     * use {@link #findCorrespondingDomText}.
-     *
-     * @param documentFragmentOrElement View element or document fragment.
-     * @returns Corresponding DOM node or document fragment.
-     */
     mapViewToDom(documentFragmentOrElement) {
         return this._viewToDomMapping.get(documentFragmentOrElement);
     }