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

package/src/view/downcastwriter.d.ts

@@ -57,7 +57,105 @@ export default class DowncastWriter {
      * @param document The view document instance.
      */
     constructor(document: Document);
+    /**
+     * Sets {@link module:engine/view/documentselection~DocumentSelection selection's} ranges and direction to the
+     * specified location based on the given {@link module:engine/view/selection~Selectable selectable}.
+     *
+     * Usage:
+     *
+     * ```ts
+     * // Sets collapsed selection at the position of given item and offset.
+     * const paragraph = writer.createContainerElement( 'p' );
+     * writer.setSelection( 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.
+     *
+     * ```ts
+     * writer.setSelection( paragraph, 'in' );
+     * ```
+     *
+     * Creates a range on the {@link module:engine/view/item~Item item} which starts before the item and ends just after the item.
+     *
+     * ```ts
+     * writer.setSelection( paragraph, 'on' );
+     * ```
+     *
+     * `DowncastWriter#setSelection()` allow passing additional options (`backward`, `fake` and `label`) as the last argument.
+     *
+     * ```ts
+     * // Sets selection as backward.
+     * writer.setSelection( element, 'in', { backward: true } );
+     *
+     * // Sets selection as fake.
+     * // 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.
+     * writer.setSelection( element, 'in', { fake: true } );
+     *
+     * // 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).
+     * writer.setSelection( element, 'in', { fake: true, label: 'foo' } );
+     * ```
+     *
+     * See also: {@link #setSelection:SELECTABLE `setSelection( selectable, options )`}.
+     *
+     * @label NODE_OFFSET
+     */
     setSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: SelectionOptions): void;
+    /**
+     * Sets {@link module:engine/view/documentselection~DocumentSelection selection's} ranges and direction to the
+     * specified location based on the given {@link module:engine/view/selection~Selectable selectable}.
+     *
+     * Usage:
+     *
+     * ```ts
+     * // Sets selection to the given range.
+     * const range = writer.createRange( start, end );
+     * writer.setSelection( range );
+     *
+     * // Sets backward 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( start2, end2 ) ];
+     * writer.setSelection( range );
+     *
+     * // Sets selection to the other selection.
+     * const otherSelection = writer.createSelection();
+     * writer.setSelection( otherSelection );
+     *
+     * // Sets collapsed selection at the given position.
+     * const position = writer.createPositionFromPath( root, path );
+     * writer.setSelection( position );
+     *
+     * // Removes all ranges.
+     * writer.setSelection( null );
+     * ```
+     *
+     * `DowncastWriter#setSelection()` allow passing additional options (`backward`, `fake` and `label`) as the last argument.
+     *
+     * ```ts
+     * // Sets selection as backward.
+     * writer.setSelection( range, { backward: true } );
+     *
+     * // Sets selection as fake.
+     * // 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.
+     * writer.setSelection( range, { fake: true } );
+     *
+     * // 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).
+     * writer.setSelection( range, { fake: true, label: 'foo' } );
+     * ```
+     *
+     * See also: {@link #setSelection:NODE_OFFSET `setSelection( node, placeOrOffset, options )`}.
+     *
+     * @label SELECTABLE
+     */
     setSelection(selectable: Exclude<Selectable, Node>, options?: SelectionOptions): void;
     /**
      * Moves {@link module:engine/view/documentselection~DocumentSelection#focus selection's focus} to the specified location.
@@ -133,6 +231,7 @@ export default class DowncastWriter {
      * writer.createContainerElement( 'span', { class: 'placeholder' }, { renderUnsafeAttributes: [ 'foo' ] } );
      * ```
      *
+     * @label WITHOUT_CHILDREN
      * @param name Name of the element.
      * @param attributes Elements attributes.
      * @param options Element's options.
@@ -160,6 +259,7 @@ export default class DowncastWriter {
      * ], { renderUnsafeAttributes: [ 'foo' ] } );
      * ```
      *
+     * @label WITH_CHILDREN
      * @param name Name of the element.
      * @param attributes Elements attributes.
      * @param children A node or a list of nodes to be inserted into the created element.
@@ -323,6 +423,7 @@ export default class DowncastWriter {
      * {@link module:engine/controller/datacontroller~DataController#addStyleProcessorRules a particular style processor rule is enabled}.
      * See {@link module:engine/view/stylesmap~StylesMap#set `StylesMap#set()`} for details.
      *
+     * @label KEY_VALUE
      * @param property Property name.
      * @param value Value to set.
      * @param element Element to set styles on.
@@ -342,6 +443,7 @@ export default class DowncastWriter {
      * {@link module:engine/controller/datacontroller~DataController#addStyleProcessorRules a particular style processor rule is enabled}.
      * See {@link module:engine/view/stylesmap~StylesMap#set `StylesMap#set()`} for details.
      *
+     * @label OBJECT
      * @param property Object with key - value pairs.
      * @param element Element to set styles on.
      */
@@ -647,7 +749,97 @@ export default class DowncastWriter {
      * @param element Element which is a parent for the range.
      */
     createRangeIn(element: Element | DocumentFragment): Range;
+    /**
+     * Creates new {@link module:engine/view/selection~Selection} instance.
+     *
+     * ```ts
+     * // Creates collapsed selection at the position of given item and offset.
+     * const paragraph = writer.createContainerElement( 'p' );
+     * 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 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>, option?: SelectionOptions): Selection;
     /**
      * Creates placeholders for child elements of the {@link module:engine/conversion/downcasthelpers~DowncastHelpers#elementToStructure

package/src/view/downcastwriter.js

@@ -49,71 +49,6 @@ export default class DowncastWriter {
         this._slotFactory = null;
         this.document = document;
     }
-    /**
-     * Sets {@link module:engine/view/documentselection~DocumentSelection selection's} ranges and direction to the
-     * specified location based on the given {@link module:engine/view/selection~Selectable selectable}.
-     *
-     * Usage:
-     *
-     * ```ts
-     * // Sets selection to the given range.
-     * const range = writer.createRange( start, end );
-     * writer.setSelection( range );
-     *
-     * // Sets backward 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( start2, end2 ) ];
-     * writer.setSelection( range );
-     *
-     * // Sets selection to the other selection.
-     * const otherSelection = writer.createSelection();
-     * writer.setSelection( otherSelection );
-     *
-     * // Sets collapsed selection at the given position.
-     * const position = writer.createPositionFromPath( root, path );
-     * writer.setSelection( position );
-     *
-     * // Sets collapsed selection at the position of given item and offset.
-     * const paragraph = writer.createContainerElement( 'p' );
-     * writer.setSelection( 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.
-     *
-     * ```ts
-     * writer.setSelection( paragraph, 'in' );
-     * ```
-     *
-     * Creates a range on the {@link module:engine/view/item~Item item} which starts before the item and ends just after the item.
-     *
-     * ```ts
-     * writer.setSelection( paragraph, 'on' );
-     *
-     * // Removes all ranges.
-     * writer.setSelection( null );
-     * ```
-     *
-     * `DowncastWriter#setSelection()` allow passing additional options (`backward`, `fake` and `label`) as the last argument.
-     *
-     * ```ts
-     * // Sets selection as backward.
-     * writer.setSelection( range, { backward: true } );
-     *
-     * // Sets selection as fake.
-     * // 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.
-     * writer.setSelection( range, { fake: true } );
-     *
-     * // 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).
-     * writer.setSelection( range, { fake: true, label: 'foo' } );
-     * ```
-     */
     setSelection(...args) {
         this.document.selection._setTo(...args);
     }
@@ -957,64 +892,6 @@ export default class DowncastWriter {
     createRangeIn(element) {
         return Range._createIn(element);
     }
-    /**
-     * Creates 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( 'p' );
-     * 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/element.d.ts

@@ -396,6 +396,7 @@ export default class Element extends Node {
      * See {@link module:engine/view/stylesmap~StylesMap#set `StylesMap#set()`} for details.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#setStyle
+     * @label KEY_VALUE
      * @internal
      * @param property Property name.
      * @param value Value to set.
@@ -417,6 +418,7 @@ export default class Element extends Node {
      * See {@link module:engine/view/stylesmap~StylesMap#set `StylesMap#set()`} for details.
      *
      * @see module:engine/view/downcastwriter~DowncastWriter#setStyle
+     * @label OBJECT
      * @internal
      * @param properties Object with key - value pairs.
      * @fires change

package/src/view/node.d.ts

@@ -151,7 +151,10 @@ export default abstract class Node extends Node_base {
  *
  * Change event is bubbled – it is fired on all ancestors.
  *
- * @eventName change
+ * @eventName ~Node#change
+ * @eventName ~Node#change:children
+ * @eventName ~Node#change:attributes
+ * @eventName ~Node#change:text
  */
 export type ViewNodeChangeEvent = {
     name: 'change' | `change:${ChangeType}`;

package/src/view/observer/arrowkeysobserver.d.ts

@@ -32,7 +32,7 @@ export default class ArrowKeysObserver extends Observer {
  * Note that because {@link module:engine/view/observer/arrowkeysobserver~ArrowKeysObserver} is attached by the
  * {@link module:engine/view/view~View} this event is available by default.
  *
- * @eventName arrowKey
+ * @eventName module:engine/view/document~Document#arrowKey
  * @param data
  */
 export type ViewDocumentArrowKeyEvent = BubblingEvent<{

package/src/view/observer/clickobserver.d.ts

@@ -34,7 +34,7 @@ export default class ClickObserver extends DomEventObserver<'click'> {
  * to {@link module:engine/view/view~View} by a {@link module:engine/view/view~View#addObserver} method.
  *
  * @see module:engine/view/observer/clickobserver~ClickObserver
- * @eventName click
+ * @eventName module:engine/view/document~Document#click
  * @param data Event data.
  */
 export type ViewDocumentClickEvent = BubblingEvent<{

package/src/view/observer/compositionobserver.d.ts

@@ -41,7 +41,7 @@ export interface CompositionEventData extends DomEventData<CompositionEvent> {
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/compositionobserver~CompositionObserver
- * @eventName compositionstart
+ * @eventName module:engine/view/document~Document#compositionstart
  * @param data Event data.
  */
 export type ViewDocumentCompositionStartEvent = {
@@ -57,7 +57,7 @@ export type ViewDocumentCompositionStartEvent = {
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/compositionobserver~CompositionObserver
- * @eventName compositionupdate
+ * @eventName module:engine/view/document~Document#compositionupdate
  * @param data Event data.
  */
 export type ViewDocumentCompositionUpdateEvent = {
@@ -73,7 +73,7 @@ export type ViewDocumentCompositionUpdateEvent = {
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/compositionobserver~CompositionObserver
- * @eventName compositionend
+ * @eventName module:engine/view/document~Document#compositionend
  * @param data Event data.
  */
 export type ViewDocumentCompositionEndEvent = {

package/src/view/observer/fakeselectionobserver.d.ts

@@ -38,9 +38,6 @@ export default class FakeSelectionObserver extends Observer {
      * This method fires {@link module:engine/view/document~Document#event:selectionChange} and
      * {@link module:engine/view/document~Document#event:selectionChangeDone} events imitating behaviour of
      * {@link module:engine/view/observer/selectionobserver~SelectionObserver}.
-     *
-     * @fires selectionChange
-     * @fires selectionChangeDone
      */
     private _handleSelectionMove;
 }

package/src/view/observer/fakeselectionobserver.js

@@ -59,9 +59,6 @@ export default class FakeSelectionObserver extends Observer {
      * This method fires {@link module:engine/view/document~Document#event:selectionChange} and
      * {@link module:engine/view/document~Document#event:selectionChangeDone} events imitating behaviour of
      * {@link module:engine/view/observer/selectionobserver~SelectionObserver}.
-     *
-     * @fires selectionChange
-     * @fires selectionChangeDone
      */
     _handleSelectionMove(keyCode) {
         const selection = this.document.selection;

package/src/view/observer/focusobserver.d.ts

@@ -57,7 +57,7 @@ export default class FocusObserver extends DomEventObserver<'focus' | 'blur'> {
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/focusobserver~FocusObserver
- * @eventName focus
+ * @eventName module:engine/view/document~Document#focus
  * @param data Event data.
  */
 export type ViewDocumentFocusEvent = {
@@ -73,7 +73,7 @@ export type ViewDocumentFocusEvent = {
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/focusobserver~FocusObserver
- * @eventName blur
+ * @eventName module:engine/view/document~Document#blur
  * @param data Event data.
  */
 export type ViewDocumentBlurEvent = {

package/src/view/observer/inputobserver.d.ts

@@ -32,7 +32,7 @@ export default class InputObserver extends DomEventObserver<'beforeinput'> {
  * by default in all editor instances (attached by {@link module:engine/view/view~View}).
  *
  * @see module:engine/view/observer/inputobserver~InputObserver
- * @eventName beforeinput
+ * @eventName module:engine/view/document~Document#beforeinput
  * @param data Event data containing detailed information about the event.
  */
 export type ViewDocumentInputEvent = {
@@ -40,7 +40,7 @@ export type ViewDocumentInputEvent = {
     args: [data: InputEventData];
 };
 /**
- * The value of the {@link module:engine/view/document~ViewDocumentInputEvent} event.
+ * The value of the {@link ~ViewDocumentInputEvent} event.
  */
 export interface InputEventData extends DomEventData<InputEvent> {
     /**

package/src/view/observer/keyobserver.d.ts

@@ -34,7 +34,7 @@ export default class KeyObserver extends DomEventObserver<'keydown' | 'keyup', K
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/keyobserver~KeyObserver
- * @eventName keydown
+ * @eventName module:engine/view/document~Document#keydown
  */
 export type ViewDocumentKeyDownEvent = {
     name: 'keydown';
@@ -49,15 +49,14 @@ export type ViewDocumentKeyDownEvent = {
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/keyobserver~KeyObserver
- * @eventName keyup
+ * @eventName module:engine/view/document~Document#keyup
  */
 export type ViewDocumentKeyUpEvent = {
     name: 'keyup';
     args: [data: KeyEventData];
 };
 /**
- * The value of both events - {@link module:engine/view/document~ViewDocumentKeyDownEvent} and
- * {@link module:engine/view/document~ViewDocumentKeyUpEvent}.
+ * The value of both events - {@link ~ViewDocumentKeyDownEvent} and {@link ~ViewDocumentKeyUpEvent}.
  */
 export interface KeyEventData extends DomEventData<KeyboardEvent>, KeystrokeInfo {
     /**

package/src/view/observer/mouseobserver.d.ts

@@ -32,7 +32,7 @@ export default class MouseObserver extends DomEventObserver<'mousedown' | 'mouse
  * needs to be added to {@link module:engine/view/view~View} by the {@link module:engine/view/view~View#addObserver} method.
  *
  * @see module:engine/view/observer/mouseobserver~MouseObserver
- * @eventName mousedown
+ * @eventName module:engine/view/document~Document#mousedown
  * @param data The event data.
  */
 export type ViewDocumentMouseDownEvent = {
@@ -48,7 +48,7 @@ export type ViewDocumentMouseDownEvent = {
  * needs to be added to {@link module:engine/view/view~View} by the {@link module:engine/view/view~View#addObserver} method.
  *
  * @see module:engine/view/observer/mouseobserver~MouseObserver
- * @eventName mouseup
+ * @eventName module:engine/view/document~Document#mouseup
  * @param  data The event data.
  */
 export type ViewDocumentMouseUpEvent = {
@@ -64,7 +64,7 @@ export type ViewDocumentMouseUpEvent = {
  * needs to be added to {@link module:engine/view/view~View} by the {@link module:engine/view/view~View#addObserver} method.
  *
  * @see module:engine/view/observer/mouseobserver~MouseObserver
- * @eventName mouseup
+ * @eventName module:engine/view/document~Document#mouseover
  * @param  data The event data.
  */
 export type ViewDocumentMouseOverEvent = {
@@ -80,7 +80,7 @@ export type ViewDocumentMouseOverEvent = {
  * needs to be added to {@link module:engine/view/view~View} by the {@link module:engine/view/view~View#addObserver} method.
  *
  * @see module:engine/view/observer/mouseobserver~MouseObserver
- * @eventName mouseup
+ * @eventName module:engine/view/document~Document#mouseout
  * @param  data The event data.
  */
 export type ViewDocumentMouseOutEvent = {

package/src/view/observer/selectionobserver.d.ts

@@ -78,6 +78,7 @@ export default class SelectionObserver extends Observer {
      * @inheritDoc
      */
     destroy(): void;
+    private _reportInfiniteLoop;
     /**
      * Selection change listener. {@link module:engine/view/observer/mutationobserver~MutationObserver#flush Flush} mutations, check if
      * a selection changes and fires {@link module:engine/view/document~Document#event:selectionChange} event on every change
@@ -119,7 +120,7 @@ export type ViewDocumentSelectionEventData = {
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/selectionobserver~SelectionObserver
- * @eventName selectionChange
+ * @eventName module:engine/view/document~Document#selectionChange
  */
 export type ViewDocumentSelectionChangeEvent = {
     name: 'selectionChange';
@@ -134,7 +135,7 @@ export type ViewDocumentSelectionChangeEvent = {
  * {@link module:engine/view/view~View} this event is available by default.
  *
  * @see module:engine/view/observer/selectionobserver~SelectionObserver
- * @eventName selectionChangeDone
+ * @eventName module:engine/view/document~Document#selectionChangeDone
  */
 export type ViewDocumentSelectionChangeDoneEvent = {
     name: 'selectionChangeDone';

package/src/view/observer/selectionobserver.js

@@ -110,12 +110,13 @@ export default class SelectionObserver extends Observer {
         this._fireSelectionChangeDoneDebounced.cancel();
         this._documentIsSelectingInactivityTimeoutDebounced.cancel();
     }
-    // @if CK_DEBUG //	_reportInfiniteLoop() {
-    // @if CK_DEBUG //		throw new Error(
-    // @if CK_DEBUG //			'Selection change observer detected an infinite rendering loop.\n\n' +
-    // @if CK_DEBUG //	 		'⚠️⚠️ Report this error on https://github.com/ckeditor/ckeditor5/issues/11658.'
-    // @if CK_DEBUG //		);
-    // @if CK_DEBUG //	}
+    /* istanbul ignore next */
+    _reportInfiniteLoop() {
+        // @if CK_DEBUG //		throw new Error(
+        // @if CK_DEBUG //			'Selection change observer detected an infinite rendering loop.\n\n' +
+        // @if CK_DEBUG //	 		'⚠️⚠️ Report this error on https://github.com/ckeditor/ckeditor5/issues/11658.'
+        // @if CK_DEBUG //		);
+    }
     /**
      * Selection change listener. {@link module:engine/view/observer/mutationobserver~MutationObserver#flush Flush} mutations, check if
      * a selection changes and fires {@link module:engine/view/document~Document#event:selectionChange} event on every change
@@ -155,8 +156,7 @@ export default class SelectionObserver extends Observer {
             // Most probably you try to put the selection in the position which is not allowed
             // by the browser and browser fixes it automatically what causes `selectionchange` event on
             // which a loopback through a model tries to re-render the wrong selection and again.
-            //
-            // @if CK_DEBUG // this._reportInfiniteLoop();
+            this._reportInfiniteLoop();
             return;
         }
         // Mark the latest focus change as complete (we got new selection after the focus so the selection is in the focused element).

package/src/view/observer/tabobserver.d.ts

@@ -33,7 +33,7 @@ export default class TabObserver extends Observer {
  * Note that because {@link module:engine/view/observer/tabobserver~TabObserver} is attached by the
  * {@link module:engine/view/view~View}, this event is available by default.
  *
- * @eventName tab
+ * @eventName module:engine/view/document~Document#tab
  * @param data
  */
 export type ViewDocumentTabEvent = BubblingEvent<{

package/src/view/position.d.ts

@@ -83,7 +83,7 @@ export default class Position extends TypeCheckable {
      * getLastMatchingPosition( value => false ); // Do not move the position.
      * ```
      *
-     * @param skip Callback function. Gets {@link module:engine/view/treewalker~type TreeWalkerValue} and should
+     * @param skip Callback function. Gets {@link module:engine/view/treewalker~TreeWalkerValue} and should
      * return `true` if the value should be skipped or `false` if not.
      * @param options Object with configuration options. See {@link module:engine/view/treewalker~TreeWalker}.
      * @returns The position after the last item which matches the `skip` callback test.

package/src/view/position.js

@@ -111,7 +111,7 @@ export default class Position extends TypeCheckable {
      * getLastMatchingPosition( value => false ); // Do not move the position.
      * ```
      *
-     * @param skip Callback function. Gets {@link module:engine/view/treewalker~type TreeWalkerValue} and should
+     * @param skip Callback function. Gets {@link module:engine/view/treewalker~TreeWalkerValue} and should
      * return `true` if the value should be skipped or `false` if not.
      * @param options Object with configuration options. See {@link module:engine/view/treewalker~TreeWalker}.
      * @returns The position after the last item which matches the `skip` callback test.