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

package/src/view/selection.d.ts

@@ -360,7 +360,7 @@ export type PlaceOrOffset = number | 'before' | 'end' | 'after' | 'on' | 'in';
 /**
  * Fired whenever selection ranges are changed through {@link ~Selection Selection API}.
  *
- * @eventName change
+ * @eventName ~Selection#change
  */
 export type ViewSelectionChangeEvent = {
     name: 'change';

package/src/view/stylesmap.d.ts

@@ -655,7 +655,7 @@ export type StyleValue = string | Array<string> | Styles | BoxSides;
 /**
  * A normalizer method for a style property.
  *
- * @see module:engine/view/stylesmap~StylesMap#setNormalizer
+ * @see ~StylesProcessor#setNormalizer
  */
 export type Normalizer = (name: string) => {
     path: string;
@@ -664,12 +664,12 @@ export type Normalizer = (name: string) => {
 /**
  * An extractor callback for a style property or path string for single values.
  *
- * @see module:engine/view/stylesmap~StylesMap#setExtractor
+ * @see ~StylesProcessor#setExtractor
  */
 export type Extractor = string | ((name: string, styles: Styles) => StyleValue | undefined);
 /**
  * A reducer callback for a style property.
  *
- * @see module:engine/view/stylesmap~StylesMap#setReducer
+ * @see ~StylesProcessor#setReducer
  */
 export type Reducer = (value: StyleValue) => Array<PropertyDescriptor>;

package/src/view/typecheckable.d.ts

@@ -49,6 +49,7 @@ export default abstract class TypeCheckable {
      * imgElement.is( 'element', 'img' ); // -> true
      * imgElement.is( 'view:element', 'img' ); // -> same as above, but more precise
      * ```
+     * @label NODE
      */
     is(type: 'node' | 'view:node'): this is (Node | Text | Element | AttributeElement | ContainerElement | EditableElement | EmptyElement | RawElement | RootEditableElement | UIElement);
     /**
@@ -71,6 +72,8 @@ export default abstract class TypeCheckable {
      * element.is( 'element', 'img' ); // -> true if this is an <img> element
      * text.is( 'element', 'img' ); -> false
      * ```
+     *
+     * @label ELEMENT
      */
     is(type: 'element' | 'view:element'): this is (Element | AttributeElement | ContainerElement | EditableElement | EmptyElement | RawElement | RootEditableElement | UIElement);
     /**
@@ -96,6 +99,8 @@ export default abstract class TypeCheckable {
      * attributeElement.is( 'attributeElement', 'b' ); // -> same as above
      * text.is( 'element', 'b' ); -> false
      * ```
+     *
+     * @label ATTRIBUTE_ELEMENT
      */
     is(type: 'attributeElement' | 'view:attributeElement'): this is AttributeElement;
     /**
@@ -121,6 +126,8 @@ export default abstract class TypeCheckable {
      * containerElement.is( 'contaienrElement', 'div' ); // -> same as above
      * text.is( 'element', 'div' ); -> false
      * ```
+     *
+     * @label CONTAINER_ELEMENT
      */
     is(type: 'containerElement' | 'view:containerElement'): this is ContainerElement | EditableElement | RootEditableElement;
     /**
@@ -146,6 +153,8 @@ export default abstract class TypeCheckable {
      * editableElement.is( 'editableElement', 'div' ); // -> same as above
      * text.is( 'element', 'div' ); -> false
      * ```
+     *
+     * @label EDITABLE_ELEMENT
      */
     is(type: 'editableElement' | 'view:editableElement'): this is EditableElement | RootEditableElement;
     /**
@@ -171,6 +180,8 @@ export default abstract class TypeCheckable {
      * emptyElement.is( 'emptyElement', 'img' ); // -> same as above
      * text.is( 'element', 'img' ); -> false
      * ```
+     *
+     * @label EMPTY_ELEMENT
      */
     is(type: 'emptyElement' | 'view:emptyElement'): this is EmptyElement;
     /**
@@ -196,6 +207,8 @@ export default abstract class TypeCheckable {
      * rawElement.is( 'rawElement', 'img' ); // -> same as above
      * text.is( 'img' ); -> false
      * ```
+     *
+     * @label RAW_ELEMENT
      */
     is(type: 'rawElement' | 'view:rawElement'): this is RawElement;
     /**
@@ -222,6 +235,8 @@ export default abstract class TypeCheckable {
      * rootEditableElement.is( 'rootElement', 'div' ); // -> same as above
      * text.is( 'element', 'div' ); -> false
      * ```
+     *
+     * @label ROOT_ELEMENT
      */
     is(type: 'rootElement' | 'view:rootElement'): this is RootEditableElement;
     /**
@@ -247,6 +262,8 @@ export default abstract class TypeCheckable {
      * uiElement.is( 'uiElement', 'span' ); // -> same as above
      * text.is( 'element', 'span' ); -> false
      * ```
+     *
+     * @label UI_ELEMENT
      */
     is(type: 'uiElement' | 'view:uiElement'): this is UIElement;
     /**
@@ -262,6 +279,8 @@ export default abstract class TypeCheckable {
      * text.is( 'element' ); // -> false
      * text.is( 'range' ); // -> false
      * ```
+     *
+     * @label TEXT
      */
     is(type: '$text' | 'view:$text'): this is Text;
     /**
@@ -275,6 +294,8 @@ export default abstract class TypeCheckable {
      * docFrag.is( 'element' ); // -> false
      * docFrag.is( 'node' ); // -> false
      * ```
+     *
+     * @label DOCUMENT_FRAGMENT
      */
     is(type: 'documentFragment' | 'view:documentFragment'): this is DocumentFragment;
     /**
@@ -291,6 +312,8 @@ export default abstract class TypeCheckable {
      *
      * **Note:** Until version 20.0.0 this method wasn't accepting `'$textProxy'` type. The legacy `'textProxy'` type is still
      * accepted for backward compatibility.
+     *
+     * @label TEXT_PROXY
      */
     is(type: '$textProxy' | 'view:$textProxy'): this is TextProxy;
     /**
@@ -304,6 +327,8 @@ export default abstract class TypeCheckable {
      * position.is( 'element' ); // -> false
      * position.is( 'range' ); // -> false
      * ```
+     *
+     * @label POSITION
      */
     is(type: 'position' | 'view:position'): this is Position;
     /**
@@ -317,6 +342,8 @@ export default abstract class TypeCheckable {
      * range.is( 'element' ); // -> false
      * range.is( 'selection' ); // -> false
      * ```
+     *
+     * @label RANGE
      */
     is(type: 'range' | 'view:range'): this is Range;
     /**
@@ -331,6 +358,8 @@ export default abstract class TypeCheckable {
      * selection.is( 'element' ); // -> false
      * selection.is( 'range' ); // -> false
      * ```
+     *
+     * @label SELECTION
      */
     is(type: 'selection' | 'view:selection'): this is Selection | DocumentSelection;
     /**
@@ -346,54 +375,72 @@ export default abstract class TypeCheckable {
      * docSelection.is( 'element' ); // -> false
      * docSelection.is( 'node' ); // -> false
      * ```
+     *
+     * @label DOCUMENT_SELECTION
      */
     is(type: 'documentSelection' | 'view:documentSelection'): this is DocumentSelection;
     /**
      * Checks whether the object is of type {@link module:engine/view/element~Element} or its subclass and has the specified `name`.
+     *
+     * @label ELEMENT_NAME
      */
     is<N extends string>(type: 'element' | 'view:element', name: N): this is (Element | AttributeElement | ContainerElement | EditableElement | EmptyElement | RawElement | RootEditableElement | UIElement) & {
         name: N;
     };
     /**
      * Checks whether the object is of type {@link module:engine/view/attributeelement~AttributeElement} and has the specified `name`.
+     *
+     * @label ATTRIBUTE_ELEMENT_NAME
      */
     is<N extends string>(type: 'attributeElement' | 'view:attributeElement', name: N): this is AttributeElement & {
         name: N;
     };
     /**
-     * Checks whether the object is of type {@link module:engine/view/containerElement~ContainerElement}
+     * Checks whether the object is of type {@link module:engine/view/containerelement~ContainerElement}
      * or its subclass and has the specified `name`.
+     *
+     * @label CONTAINER_ELEMENT_NAME
      */
     is<N extends string>(type: 'containerElement' | 'view:containerElement', name: N): this is (ContainerElement | EditableElement | RootEditableElement) & {
         name: N;
     };
     /**
-     * Checks whether the object is of type {@link module:engine/view/editableElement~EditableElement}
+     * Checks whether the object is of type {@link module:engine/view/editableelement~EditableElement}
      * or its subclass and has the specified `name`.
+     *
+     * @label EDITABLE_ELEMENT_NAME
      */
     is<N extends string>(type: 'editableElement' | 'view:editableElement', name: N): this is (EditableElement | RootEditableElement) & {
         name: N;
     };
     /**
      * Checks whether the object is of type {@link module:engine/view/emptyelement~EmptyElement} has the specified `name`.
+     *
+     * @label EMPTY_ELEMENT_NAME
      */
     is<N extends string>(type: 'emptyElement' | 'view:emptyElement', name: N): this is EmptyElement & {
         name: N;
     };
     /**
      * Checks whether the object is of type {@link module:engine/view/rawelement~RawElement} and has the specified `name`.
+     *
+     * @label RAW_ELEMENT_NAME
      */
     is<N extends string>(type: 'rawElement' | 'view:rawElement', name: N): this is RawElement & {
         name: N;
     };
     /**
      * Checks whether the object is of type {@link module:engine/view/rooteditableelement~RootEditableElement} and has the specified `name`.
+     *
+     * @label ROOT_ELEMENT_NAME
      */
     is<N extends string>(type: 'rootElement' | 'view:rootElement', name: N): this is RootEditableElement & {
         name: N;
     };
     /**
      * Checks whether the object is of type {@link module:engine/view/uielement~UIElement} and has the specified `name`.
+     *
+     * @label UI_ELEMENT_NAME
      */
     is<N extends string>(type: 'uiElement' | 'view:uiElement', name: N): this is UIElement & {
         name: N;

package/src/view/uielement.d.ts

@@ -71,7 +71,7 @@ export default class UIElement extends Element {
      * ```
      *
      * If changes in your UI element should trigger some editor UI update you should call
-     * the {@link module:core/editor/editorui~EditorUI#update `editor.ui.update()`} method
+     * the {@link module:ui/editorui/editorui~EditorUI#update `editor.ui.update()`} method
      * after rendering your UI element.
      *
      * @param domConverter Instance of the DomConverter used to optimize the output.

package/src/view/uielement.js

@@ -79,7 +79,7 @@ export default class UIElement extends Element {
      * ```
      *
      * If changes in your UI element should trigger some editor UI update you should call
-     * the {@link module:core/editor/editorui~EditorUI#update `editor.ui.update()`} method
+     * the {@link module:ui/editorui/editorui~EditorUI#update `editor.ui.update()`} method
      * after rendering your UI element.
      *
      * @param domConverter Instance of the DomConverter used to optimize the output.

package/src/view/upcastwriter.d.ts

@@ -92,7 +92,6 @@ export default class UpcastWriter {
      * @see module:engine/view/element~Element#_appendChild
      * @param items Items to be inserted.
      * @param element Element to which items will be appended.
-     * @fires change
      * @returns Number of appended nodes.
      */
     appendChild(items: Item | string | Iterable<Item | string>, element: Element | DocumentFragment): number;
@@ -104,7 +103,6 @@ export default class UpcastWriter {
      * @param index Offset at which nodes should be inserted.
      * @param items Items to be inserted.
      * @param element Element to which items will be inserted.
-     * @fires change
      * @returns Number of inserted nodes.
      */
     insertChild(index: number, items: Item | Iterable<Item>, element: Element | DocumentFragment): number;
@@ -115,7 +113,6 @@ export default class UpcastWriter {
      * @param index Offset from which nodes will be removed.
      * @param howMany Number of nodes to remove.
      * @param element Element which children will be removed.
-     * @fires change
      * @returns The array containing removed nodes.
      */
     removeChildren(index: number, howMany: number, element: Element | DocumentFragment): Array<Node>;
@@ -215,6 +212,7 @@ export default class UpcastWriter {
      * See {@link module:engine/view/stylesmap~StylesMap#set `StylesMap#set()`} for details.
      *
      * @see module:engine/view/element~Element#_setStyle
+     * @label KEY_VALUE
      * @param property Property name.
      * @param value Value to set.
      * @param element Element for which style will be added.
@@ -235,6 +233,7 @@ export default class UpcastWriter {
      * See {@link module:engine/view/stylesmap~StylesMap#set `StylesMap#set()`} for details.
      *
      * @see module:engine/view/element~Element#_setStyle
+     * @label OBJECT
      * @param properties Object with key - value pairs.
      * @param element Element for which style will be added.
      */
@@ -323,6 +322,96 @@ export default class UpcastWriter {
      * @param element Element which is a parent for the range.
      */
     createRangeIn(element: Element | DocumentFragment): Range;
+    /**
+     * Creates a new {@link module:engine/view/selection~Selection} instance.
+     *
+     * ```ts
+     * // Creates collapsed selection at the position of given item and offset.
+     * const paragraph = writer.createContainerElement( 'paragraph' );
+     * const selection = writer.createSelection( 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 = writer.createSelection( 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 = writer.createSelection( paragraph, 'on' );
+     * ```
+     *
+     * `Selection`'s constructor allow passing additional options (`backward`, `fake` and `label`) as the last argument.
+     *
+     * ```ts
+     * // Creates backward selection.
+     * const selection = writer.createSelection( 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 = writer.createSelection( element, 'in', { fake: true, label: 'foo' } );
+     * ```
+     *
+     * See also: {@link #createSelection:SELECTABLE `createSelection( selectable, options )`}.
+     *
+     * @label NODE_OFFSET
+     */
     createSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: SelectionOptions): Selection;
+    /**
+     * Creates a new {@link module:engine/view/selection~Selection} instance.
+     *
+     * ```ts
+     * // Creates empty selection without ranges.
+     * const selection = writer.createSelection();
+     *
+     * // Creates selection at the given range.
+     * const range = writer.createRange( start, end );
+     * const selection = writer.createSelection( range );
+     *
+     * // Creates selection at the given ranges
+     * const ranges = [ writer.createRange( start1, end2 ), writer.createRange( star2, end2 ) ];
+     * const selection = writer.createSelection( ranges );
+     *
+     * // Creates selection from the other selection.
+     * const otherSelection = writer.createSelection();
+     * const selection = writer.createSelection( otherSelection );
+     *
+     * // Creates selection from the document selection.
+     * const selection = writer.createSelection( editor.editing.view.document.selection );
+     *
+     * // Creates selection at the given position.
+     * const position = writer.createPositionFromPath( root, path );
+     * const selection = writer.createSelection( position );
+     * ```
+     *
+     * `Selection`'s constructor allow passing additional options (`backward`, `fake` and `label`) as the last argument.
+     *
+     * ```ts
+     * // Creates backward selection.
+     * const selection = writer.createSelection( 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 = writer.createSelection( range, { fake: true, label: 'foo' } );
+     * ```
+     *
+     * See also: {@link #createSelection:NODE_OFFSET `createSelection( node, placeOrOffset, options )`}.
+     *
+     * @label SELECTABLE
+     */
     createSelection(selectable?: Exclude<Selectable, Node>, options?: SelectionOptions): Selection;
 }

package/src/view/upcastwriter.js

@@ -96,7 +96,6 @@ export default class UpcastWriter {
      * @see module:engine/view/element~Element#_appendChild
      * @param items Items to be inserted.
      * @param element Element to which items will be appended.
-     * @fires change
      * @returns Number of appended nodes.
      */
     appendChild(items, element) {
@@ -110,7 +109,6 @@ export default class UpcastWriter {
      * @param index Offset at which nodes should be inserted.
      * @param items Items to be inserted.
      * @param element Element to which items will be inserted.
-     * @fires change
      * @returns Number of inserted nodes.
      */
     insertChild(index, items, element) {
@@ -123,7 +121,6 @@ export default class UpcastWriter {
      * @param index Offset from which nodes will be removed.
      * @param howMany Number of nodes to remove.
      * @param element Element which children will be removed.
-     * @fires change
      * @returns The array containing removed nodes.
      */
     removeChildren(index, howMany, element) {
@@ -356,64 +353,6 @@ export default class UpcastWriter {
     createRangeIn(element) {
         return Range._createIn(element);
     }
-    /**
-     * Creates a new {@link module:engine/view/selection~Selection} instance.
-     *
-     * ```ts
-     * // Creates empty selection without ranges.
-     * const selection = writer.createSelection();
-     *
-     * // Creates selection at the given range.
-     * const range = writer.createRange( start, end );
-     * const selection = writer.createSelection( range );
-     *
-     * // Creates selection at the given ranges
-     * const ranges = [ writer.createRange( start1, end2 ), writer.createRange( star2, end2 ) ];
-     * const selection = writer.createSelection( ranges );
-     *
-     * // Creates selection from the other selection.
-     * const otherSelection = writer.createSelection();
-     * const selection = writer.createSelection( otherSelection );
-     *
-     * // Creates selection from the document selection.
-     * const selection = writer.createSelection( editor.editing.view.document.selection );
-     *
-     * // Creates selection at the given position.
-     * const position = writer.createPositionFromPath( root, path );
-     * const selection = writer.createSelection( position );
-     *
-     * // Creates collapsed selection at the position of given item and offset.
-     * const paragraph = writer.createContainerElement( 'paragraph' );
-     * const selection = writer.createSelection( 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 = writer.createSelection( 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 = writer.createSelection( paragraph, 'on' );
-     * ```
-     *
-     * `Selection`'s constructor allow passing additional options (`backward`, `fake` and `label`) as the last argument.
-     *
-     * ```ts
-     * // Creates backward selection.
-     * const selection = writer.createSelection( 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 = writer.createSelection( range, { fake: true, label: 'foo' } );
-     * ```
-     */
     createSelection(...args) {
         return new Selection(...args);
     }

package/src/view/view.d.ts

@@ -286,7 +286,97 @@ export default class View extends View_base {
      * @param element Element which is a parent for the range.
      */
     createRangeIn(element: Element): Range;
+    /**
+     * Creates new {@link module:engine/view/selection~Selection} instance.
+     *
+     * ```ts
+     * // Creates collapsed selection at the position of given item and offset.
+     * const paragraph = view.createContainerElement( 'paragraph' );
+     * const selection = view.createSelection( 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 = view.createSelection( 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 = view.createSelection( paragraph, 'on' );
+     * ```
+     *
+     * `Selection`'s factory method allow passing additional options (`backward`, `fake` and `label`) as the last argument.
+     *
+     * ```ts
+     * // Creates backward selection.
+     * const selection = view.createSelection( paragraph, '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 = view.createSelection( element, 'in', { fake: true, label: 'foo' } );
+     * ```
+     *
+     * See also: {@link #createSelection:SELECTABLE `createSelection( selectable, options )`}.
+     *
+     * @label NODE_OFFSET
+     */
     createSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: SelectionOptions): Selection;
+    /**
+     * Creates new {@link module:engine/view/selection~Selection} instance.
+     *
+     * ```ts
+     * // Creates empty selection without ranges.
+     * const selection = view.createSelection();
+     *
+     * // Creates selection at the given range.
+     * const range = view.createRange( start, end );
+     * const selection = view.createSelection( range );
+     *
+     * // Creates selection at the given ranges
+     * const ranges = [ view.createRange( start1, end2 ), view.createRange( star2, end2 ) ];
+     * const selection = view.createSelection( ranges );
+     *
+     * // Creates selection from the other selection.
+     * const otherSelection = view.createSelection();
+     * const selection = view.createSelection( otherSelection );
+     *
+     * // Creates selection from the document selection.
+     * const selection = view.createSelection( editor.editing.view.document.selection );
+     *
+     * // Creates selection at the given position.
+     * const position = view.createPositionFromPath( root, path );
+     * const selection = view.createSelection( position );
+     * ```
+     *
+     * `Selection`'s factory method allow passing additional options (`backward`, `fake` and `label`) as the last argument.
+     *
+     * ```ts
+     * // Creates backward selection.
+     * const selection = view.createSelection( 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 = view.createSelection( range, { fake: true, label: 'foo' } );
+     * ```
+     *
+     * See also: {@link #createSelection:NODE_OFFSET `createSelection( node, placeOrOffset, options )`}.
+     *
+     * @label SELECTABLE
+     */
     createSelection(selectable?: Exclude<Selectable, Node>, options?: SelectionOptions): Selection;
     /**
      * Disables or enables rendering. If the flag is set to `true` then the rendering will be disabled.
@@ -318,7 +408,7 @@ export default class View extends View_base {
  * balloon panel. If you wants to change view structure use
  * {@link module:engine/view/document~Document#registerPostFixer post-fixers}.
  *
- * @eventName render
+ * @eventName ~View#render
  */
 export type ViewRenderEvent = {
     name: 'render';

package/src/view/view.js

@@ -347,8 +347,9 @@ export default class View extends ObservableMixin() {
              * cause some unexpected behaviour and inconsistency between the DOM and the view.
              * This may be caused by:
              *
-             * * calling {@link #change} or {@link #forceRender} during rendering process,
-             * * calling {@link #change} or {@link #forceRender} inside of
+             * * calling {@link module:engine/view/view~View#change} or {@link module:engine/view/view~View#forceRender} during rendering
+             * process,
+             * * calling {@link module:engine/view/view~View#change} or {@link module:engine/view/view~View#forceRender} inside of
              *   {@link module:engine/view/document~Document#registerPostFixer post-fixer function}.
              *
              * @error cannot-change-view-tree
@@ -467,64 +468,6 @@ export default class View extends ObservableMixin() {
     createRangeIn(element) {
         return Range._createIn(element);
     }
-    /**
-     Creates new {@link module:engine/view/selection~Selection} instance.
-     *
-     * ```ts
-     * // Creates empty selection without ranges.
-     * const selection = view.createSelection();
-     *
-     * // Creates selection at the given range.
-     * const range = view.createRange( start, end );
-     * const selection = view.createSelection( range );
-     *
-     * // Creates selection at the given ranges
-     * const ranges = [ view.createRange( start1, end2 ), view.createRange( star2, end2 ) ];
-     * const selection = view.createSelection( ranges );
-     *
-     * // Creates selection from the other selection.
-     * const otherSelection = view.createSelection();
-     * const selection = view.createSelection( otherSelection );
-     *
-     * // Creates selection from the document selection.
-     * const selection = view.createSelection( editor.editing.view.document.selection );
-     *
-     * // Creates selection at the given position.
-     * const position = view.createPositionFromPath( root, path );
-     * const selection = view.createSelection( position );
-     *
-     * // Creates collapsed selection at the position of given item and offset.
-     * const paragraph = view.createContainerElement( 'paragraph' );
-     * const selection = view.createSelection( 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 = view.createSelection( 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 = view.createSelection( paragraph, 'on' );
-     * ```
-     *
-     * `Selection`'s factory method allow passing additional options (`backward`, `fake` and `label`) as the last argument.
-     *
-     * ```ts
-     * // Creates backward selection.
-     * const selection = view.createSelection( 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 = view.createSelection( range, { fake: true, label: 'foo' } );
-     * ```
-     */
     createSelection(...args) {
         return new Selection(...args);
     }